home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / comunic / zcdc1805.zip / ZCOMMDOC.AH < prev    next >
Text File  |  1993-05-30  |  74KB  |  1,771 lines
  1.  
  2.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  3.       ZCOMM User Manual                                                  211
  4.  
  5.          SEE ALSO: n numeric parameter
  6.  
  7.       s  Set the attribute of the status line display (default 7, for
  8.          white).  A value of 8 (grey) may be chosen to prevent the status
  9.          line display from distracting from the information being printed.
  10.          The low intensity grey also minimizes phosphor burn.  Some other
  11.          possibilities are 2 for green, and 1 for blue (or underlined on the
  12.          monochrome board).
  13.  
  14.          SEE ALSO: n numeric parameter
  15.  
  16.       t  Sets the throttle speed (delay between characters in hundredths of
  17.          seconds) used by the term function when uploading files with an f
  18.          -t file command.  Throttle controls the term function sending speed
  19.          only when t term option is enabled.
  20.  
  21.          The default value of 4 corresponds to about 20 characters per
  22.          second.  Larger numbers give slower transmission.  The effective
  23.          resolution of the t parameter is limited by the timekeeping
  24.          resolution of the operating system; on PC-DOS the resolution is
  25.          about 18 per second.
  26.  
  27.          A negative value (-1 to -32767) may be used to specify a software
  28.          timing loop, with more negative values giving slower transmission.
  29.          The speed effect of a negative t value depends on the processor
  30.          speed and operating environment.
  31.  
  32.          The t parameter is reset to its default by the call command.
  33.  
  34.          SEE ALSO: t term option
  35.  
  36.       u  Sets the video attribute used to represent underline.
  37.  
  38.          EXAMPLE: pu14 sets "underline" to yellow.
  39.  
  40.          Adding 1024 to this parameter forces ANSI SGR 3 or 4 to use this
  41.          color.
  42.  
  43.          SEE ALSO: n numeric parameter
  44.  
  45.       v  Sets the verbose level (default 0).  A value less than zero
  46.          inhibits some routine messages.  A value og 1 or greater enables
  47.          logging of files skipped by selective ZMODEM file transfers.  A
  48.          value greater then zero causes the set command to list all string
  49.          parameters, including empty string parameters.  The screen erase
  50.          after data calls in host operation is disabled.  Values greater
  51.          than 1 display script commands as they are fetched from the script
  52.          file.* Larger values give more detailed tracing information.  A
  53.          value of 50+ causes data read by the read command to be displayed
  54.          and acted upon by the term function (when called) as if it had
  55.          arrived from the remote.
  56.  
  57.  
  58.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  59.  
  60.  
  61.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  62.       ZCOMM User Manual                                                  212
  63.  
  64.          NOTE: A v parameter value greater than zero affects scripts that
  65.          generate files with the > command.
  66.  
  67.       w  Controls the block length used by the CompuServe B Protocol.  A
  68.          longer length increases throughput, but may overload some networks,
  69.          resulting in excessive retransmissions or failed transfers.  The
  70.          maximum B+ block length is 1024 data bytes.  A value of 0 (the
  71.          default) allows the Compuserve computer to control the block
  72.          length.  A negative value controls the upload block length but
  73.          still allows Compuserve to control the download block length.
  74.          Uploads to Compuserve using longer block lengths are sensitive to
  75.          poor flow control, especially when error correcting modems (MNP,
  76.          etc.) are used.  If B+ uploads fail or require excessive
  77.          retransmissions, correct the flow control arrangements, disable the
  78.          modem's error correction, or try a smaller upload block size.
  79.  
  80.          The data contents of successfully transferred files are not
  81.          affected by this parameter.
  82.  
  83.       x  Sets the port number linked with the link command.
  84.  
  85.          SEE ALSO: link command, y numeric parameter
  86.  
  87.       y  Sets the transmission speed used by the linked port.
  88.  
  89.          SEE ALSO: link command, x numeric parameter
  90.  
  91.       z  Set the timeZone in minutes behind GMT (Greenwich Mean Time).
  92.  
  93.          EXAMPLE: pz300 sets timezone 300 minutes behind GMT for EST.
  94.  
  95.  
  96.          EXAMPLE: pz480 sets timezone 480 minutes behind GMT for PST.
  97.  
  98.  
  99.          SEE ALSO: d numeric parameter, ZONE environment variable
  100.  
  101.       _  The _ numeric parameter controls the action taken by ZCOMM when a
  102.          fatal error (one that generates the "ZCOMM: Error..." message).
  103.          Any non zero value causes DTR to be dropped (disconnect the modem).
  104.          A value greater than 100 causes ZCOMM to exit to the operating
  105.          system.  The NUKE key does not invoke this processing.
  106.  
  107.          EXAMPLE: p_101
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  118.  
  119.  
  120.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  121.       ZCOMM User Manual                                                  213
  122.  
  123.       24.1  Kermit Numeric Parameters
  124.  
  125.       The Super-Kermit parameters control Kermit protocol transfers.  They
  126.       are set with the kermit px# command.  Their current values may be
  127.       displayed with a kermit p command.  These parameters rarely need
  128.       changing for most systems.  They can be changed in case of difficulty
  129.       with Kermit transfers, especially with mainframe programs or obscure
  130.       microcomputer Kermit impelementations.
  131.  
  132.       Certain of these parameters require character values expressed in
  133.       decimal.  The ASCII code chart in Chapter 37 gives the decimal value
  134.       of all ASCII characters.
  135.  
  136.       When transferring files with Kermit programs operating on IBM
  137.       mainframes with half duplex front ends, the kermit i parameter should
  138.       be set to 1, and the kermit s parameter set to the longest response
  139.       time expected, perhaps 45 seconds.
  140.  
  141.       EXAMPLE: kermit pi1;  kermit ps45
  142.  
  143.  
  144.       SEE ALSO: Kermit protocol in Chapter 13
  145.  
  146.       7 If non zero, force seven bit line transmission with eighth bit
  147.         quoting Kermit transmission even if ZCOMM is otherwise using eight
  148.         bits no parity.  This parameter is reset by the call command.
  149.  
  150.       8 If non zero, force 8 bit transparent Kermit transmission even if
  151.         ZCOMM is otherwise using seven bit line transmission.  Normally, the
  152.         Kermit file transfer commands use 7 bit line transmission and
  153.         attempt to negotiate 8th bit quoting if one of the 7 bit term
  154.         options (7e, 7o, 7m, 7s) is used.  This parameter is reset by the
  155.         call command.
  156.  
  157.       a Incoming packet-start character, default 1 (SOH).
  158.  
  159.       A Outgoing packet-start character, default 1 (SOH).
  160.  
  161.       b Block check type requested: 1=1 byte checksum, 2=2 byte checksum,
  162.         3=3 byte CRC-16 (default).  Selecting a type 1 checksum instead of
  163.         type 3 will increase throughput by 2-4 percent[3] at the expense of
  164.         weaker error checking.  The probability of undetected errors when
  165.         using Kermit in checksum mode instead of CRC-16 increases
  166.         dramatically with noisy lines and longer packets.
  167.  
  168.  
  169.  
  170.       __________
  171.  
  172.        3. for 96 byte packets
  173.  
  174.  
  175.  
  176.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  177.  
  178.  
  179.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  180.       ZCOMM User Manual                                                  214
  181.  
  182.       c Control prefix in incoming data, default 35 (pound sign).
  183.  
  184.       C Control prefix in outgoing data, default 35 (pound sign).
  185.  
  186.       d Delay in seconds before initial sending, default 0.
  187.  
  188.       e Incoming end of line character, default 13 (CR).
  189.  
  190.       E Outgoing end of line character, default 13 (CR).
  191.  
  192.       i Use IBM line turnaround, default 0 (don't use IBM line turnaround).
  193.         The Kermit x numeric parameter sets the turnaround character.  This
  194.         may be necessary when communicating with IBM mainframes with half
  195.         duplex front ends.
  196.  
  197.       l Maximum outgoing packet length, default 1000, 1000 maximum.  A value
  198.         greater than 94 implies Kermit long packets.  The receiving program
  199.         may force shorter packets.
  200.  
  201.       L Maximum incoming packet length, default 1000, 1000 maximum.  A value
  202.         greater than 94 implies Kermit long packets.  This sets a limit; the
  203.         sending program may use shorter packets.
  204.  
  205.       p Sets the number of padding characters (default 0) to send before and
  206.         after each transmitted packet.
  207.  
  208.         SEE ALSO: kermit y numeric parameter
  209.  
  210.       r If non zero, remove incomplete files received with a protocol except
  211.         those received with the + option (default 0).
  212.  
  213.       s Timeout interval in seconds waiting for XON characters or positive
  214.         flow control (default 15).  If an XON is not received within this
  215.         time, transmission resumes anyway.  A value of 0 disables this
  216.         timeout.
  217.  
  218.       t Override timeout interval in seconds for incoming packets.  The
  219.         default of 0 allows the other program to specifiy the timeout.
  220.  
  221.       T Timeout interval for outgoing packets, default 4 seconds.
  222.  
  223.       v Eighth bit quoting character, default 38 (ampersand).  Sliding
  224.         Window size in Kermit packets, 1 minimum, 31 maximum, 15 default.
  225.         Setting w to zero disables the sliding window.
  226.  
  227.       x IBM turnaround character, default 17 (XON).
  228.  
  229.       y Pad character to send, default 0 (NUL).
  230.  
  231.         SEE ALSO: kermit p numeric parameter
  232.  
  233.  
  234.  
  235.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  236.  
  237.  
  238.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  239.       ZCOMM User Manual                                                  215
  240.  
  241.       24.2  X/Y/ZMODEM Numeric Parameters
  242.  
  243.       These parameters control XMODEM, YMODEM, and ZMODEM protocol
  244.       transfers.  They are set with the z px# command available with ZMODEM
  245.       flavors of ZCOMM.
  246.  
  247.       EXAMPLE: z pl16384
  248.       Forces ZMODEM packet length of 16384 (default packet length is
  249.       infinite).
  250.  
  251.       Their current values can be displayed with a z p command.  These
  252.       parameters rarely need changing in normal environments.
  253.  
  254.       b If non zero, ZMODEM sends a break when it is sending a file and
  255.         receives a retransmission request.  This mode of operation may be
  256.         used with high speed modems to clear unwanted characters from the
  257.         modem's buffer during error recovery.  Usually, the modem must be
  258.         given a configuration command to make it clear its transmit buffer
  259.         when receiving a break signal.
  260.  
  261.       B Sets the duration of the break signal in tenths of a second, default
  262.         2 (200 milliseconds).
  263.  
  264.       c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers.
  265.         Setting this parameter to 0 accommodates programs with non standard
  266.         XMODEM/YMODEM protocols and slightly quickens file transfers.  The
  267.         default value of 1 provides optimum reliability for XMODEM and
  268.         YMODEM transfers with programs that meet the XMODEM/YMODEM spec.
  269.  
  270.         Setting this parameter to -1 disables error checking provided by the
  271.         r option.
  272.  
  273.  
  274.       C Sets the number of times ZMODEM will attempt to send a command (as a
  275.         result of a zcommand command) (default 11).
  276.  
  277.       d Sets a delay time in tenths of seconds that the sz command will wait
  278.         for a ZMODEM packet in response to the rz<ENTER> string it sends to
  279.         the remote before sending a ZMODEM packet.  This facilitates
  280.         automatic ZMODEM uploads to VMS, which interrupts programs with the
  281.         Ctrl-X character.  The call command resets this parameter to its
  282.         default of 1.  Higher values increase the startup time when the
  283.         receiving ZMODEM program is started before the sender.
  284.  
  285.       e If non zero, escape all control characters.  This allows ZMODEM
  286.         transfers to operate over data PBX and other systems that freak out
  287.         when they receive control characters.
  288.  
  289.       d Some operating systems, most notably VAX/VMS, use ^X to stop
  290.         programs.  ZMODEM uploads consist of a "rz" command to start the rz
  291.         program followed by a ZMODEM packet.  If the ^X in the ZMODEM packet
  292.  
  293.  
  294.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  295.  
  296.  
  297.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  298.       ZCOMM User Manual                                                  216
  299.  
  300.         causes problems, the zmodem d parameter can be used to delay the
  301.         initial ZMODEM packet until the rz program initializes itself.  The
  302.         zmodem d parameter sets a delay in tenths of a second on ZMODEM
  303.         sends (uploads) between the "rz" command and the first packet.
  304.  
  305.       f Flow control mask, only used with Unix/Xenix systems.  Setting this
  306.         to 0 (the default) disables hardware (RTS/CTS) flow control for
  307.         Xenix/Unix systems with broken hardware flow control.  On Xenix/Unix
  308.         systems where only CTS flow control works properly, set this to 8192
  309.         to allow CTS flow control only.
  310.  
  311.         Use 32768 for newer SCO systems that support CRTSFL.
  312.  
  313.       F Sets the pause after each data subpacket sent with the sz command
  314.         when the F option is used, or when failing flow control is detected.
  315.         The default value of 1 causes a one tenth second delay.
  316.  
  317.         SEE ALSO: F option On some Unix operating systems the pause will be
  318.         rounded up to the next second or two.
  319.  
  320.       l Normally, the ZMODEM "packet length" ("block length") is the file
  321.         length.  Setting this parameter non zero forces ZMODEM to close a
  322.         frame and wait for an ACK after each # bytes (default 0).  This
  323.         makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after
  324.         each block/packet for an acknowledgement before going on to the next
  325.         block.  The packet length may be adjusted to prevent buffer overflow
  326.         in data PBX systems.  The call command resets this parameter to 0.
  327.  
  328.       L (Default 0) If non zero, overrides the nominal length of data
  329.         subpackets within each ZMODEM frame.  A smaller value speeds error
  330.         recovery on noisy lines, a large value (maximum 1024) reduces the
  331.         overhead of CRC characters.  The call command resets this parameter
  332.         to 0.
  333.  
  334.         Please note that streaming ZMODEM has no direct equivalent to
  335.         XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is
  336.         set non zero.  In the absence of errors, ZMODEM normally sends the
  337.         entire file without pause.  If somebody claims ZMODEM's 1024 byte
  338.         subpacket length is slowing things down by more than one half per
  339.         cent, he doesn't understand ZMODEM and should be ignored.
  340.  
  341.       n Sets the number of NULLS (default 0) sent before each ZDATA frame.
  342.         Some buffered modems (Fastcomm) have a firmware bug which loses
  343.         characters when changing the direction of transmission.  This causes
  344.         data frames to fail with a CRC or other error.  ZMODEM n parameter
  345.         values in the range of 100 to 150 have obviated this syndrome.
  346.  
  347.       P When set to 2 (the default), purge the transmit buffer and force a
  348.         receiver response when a CR/LF sequence (indicating a PC-Pursuit
  349.         DATA LOSS message) is detected.  A value of 1 does not purge the
  350.         transmit buffer.  A value of 0 disables special processing of CR/LF
  351.  
  352.  
  353.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  354.  
  355.  
  356.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  357.       ZCOMM User Manual                                                  217
  358.  
  359.         sequences received by the sending ZMODEM.
  360.  
  361.       w If non 0, restrict the ZMODEM transmit window to the specified
  362.         number of bytes.  Setting this parameter to N requests
  363.         acknowledgements from the receiver every N/4 characters.  ZCOMM then
  364.         waits for acknowledgements from the receiver whenever it has sent N
  365.         more characters than it has received acknowledgements for.  This
  366.         parameter is useful with networks with defective flow control, and
  367.         with networks that store an excessive number of characters in
  368.         transit.  The call command resets this parameter to 0.
  369.  
  370.         Setting this parameter non zero also causes the sz command to
  371.         perform an extra step that actively prevents an ALT-F given to a
  372.         receiver from generating a spurious successful file transfer
  373.         completion.
  374.  
  375.       W Adjusts the number of characters the ZMODEM receiver will silently
  376.         ignore when searching for the beginning of a new frame.  This may be
  377.         set larger to accomodate networks with excessive in transit storage,
  378.         smaller to speed error recovery from long error bursts on direct
  379.         connections.  The call command resets this parameter to the default
  380.         (1400).
  381.  
  382.       Z Number of minutes (default 0) to adjust the file modification date
  383.         when using the Telink or Clink/SEAlink file transfer protocol to
  384.         transfer a file between different time zones.
  385.  
  386.       The timeout parameters below may be set lower for faster X/YMODEM
  387.       error recovery when transferring files between two micros, higher to
  388.       accomodate extremely sluggish systems.  Only in pathological cases is
  389.       it necessary to modify these parameters.  The call command resets
  390.       these parameter to their defaults.
  391.  
  392.       p Timeout in tenths of seconds for gaps within a packet (default 100).
  393.  
  394.       r If non zero, remove incomplete files received with a protocol except
  395.         those received with the + option (default 0).
  396.  
  397.       R When non 0, limits the number of bytes of file comparision used with
  398.         the sz and rz -rr option.  This parameter may be set to a value
  399.         between 2048 and 32000 (1 billion on 32 bit systems).  This
  400.         parameter is given to the receiving program.
  401.  
  402.         EXAMPLE: z pR30000
  403.  
  404.  
  405.         SEE ALSO: -rr option
  406.  
  407.       s Timeout interval in seconds waiting for XON characters or positive
  408.         flow control (default 15).  If an XON is not received within this
  409.         time, transmission resumes anyway.  A value of 0 disables this
  410.  
  411.  
  412.       (C) 1993 Omen Tech Inc                   Chapter 24 Numeric Parameters
  413.  
  414.  
  415.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  416.       ZCOMM User Manual                                                  218
  417.  
  418.         timeout.
  419.  
  420.       t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
  421.         waiting for a packet or command acknowledgement (default 100).
  422.  
  423.       T Transmitter timeout in tenths of seconds waiting for a packet
  424.         (default 600).
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.       (C) 1993 Omen Tech Inc                    Chapter 24 String Parameters
  472.  
  473.  
  474.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  475.       ZCOMM User Manual                                                  219
  476.  
  477.       25.  STRING PARAMETERS
  478.  
  479.       Case is significant in parameter names.
  480.  
  481.       ZCOMM provides two types of string parameters, permament and
  482.       temporary.  Permanent string parameters are always defined, and most
  483.       perform specific defined functions.  The permanent string parameters
  484.       are described below.  The names of the permament string parameters may
  485.       be displayed with the command sequence pv1; set given at the command
  486.       prompt.  Without the pv1 only non empty string parameters are
  487.       displayed.
  488.  
  489.       Temporary string parameters* are created by the set, sets, accept, and
  490.       grab commands when they do not reference a permament string parameter.
  491.       Temporary string parameter names begin with any letter except y and
  492.       may have up to 16 letters or digits.
  493.  
  494.       The contents of temporary string parameters may be accessed and
  495.       modified when ZCOMM is Restricted.  New temporary string parameter
  496.       names may not be created when ZCOMM is Restricted.
  497.  
  498.       The set command without arguments displays the current values and
  499.       maximum string length for each of the non-empty string parameters.  To
  500.       set a parameter empty, enter "" as the parameter string (e.g., set
  501.       txlog "").  Certain string parameters may be entered with ZCOMM's
  502.       character escapes.
  503.  
  504.       When a string parameter is executed, it may be either sent to the
  505.       remote as a string or executed as a command if its first character is
  506.       @.
  507.  
  508.       EXAMPLE: set f7 "logout\r" programs F7 to send a string to the remote.
  509.  
  510.  
  511.       EXAMPLE: set f7 "@echo logout" programs F7 to display logout on the
  512.       screen.
  513.  
  514.  
  515.       In strings sent to the remote, a \336 (octal 336) character causes a
  516.       pause in transmission[1] (controlled by the p numeric parameter),
  517.       which may be used to send multiple commands with one string.
  518.  
  519.       An optional underscore prepended to the name of a permament string
  520.       parameter causes that string parameter to be cleared by the next call
  521.       command.
  522.  
  523.  
  524.       __________
  525.  
  526.        1. Not including the mput command
  527.  
  528.  
  529.  
  530.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  531.  
  532.  
  533.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  534.       ZCOMM User Manual                                                  220
  535.  
  536.       String parameters may be up to 129 characters in length except as
  537.       noted.  TAB characters count as one character each.
  538.  
  539.       The following string parameters may not be accessed or modified by the
  540.       set command or in string expansions when ZCOMM is Restricted:
  541.           alta...altz backtab bbs break bs esc etx exrc f1...f12 fs1...fs12
  542.           fc1...fc12 fa1...fa12 fcdel* fcdown* fcend* fchome* fcins* fcleft*
  543.           fcpgdn* fcpgup* fcright* fcup* fdel fdown fhome fins fleft fnp5*
  544.           fpgdn fpgup fright fup id0...id3 intolink* l linkpass* m oncloserx
  545.           onclosetx onexit outahost outalink* password pw0...pw3 quitcmd rub
  546.           tab unrestrict xpassword*
  547.  
  548.       The following may not be modified by the set command when ZCOMM is
  549.       restricted:
  550.           MODEM answerback altprompt baudstr blankfill call1** call2 call3*
  551.           callers* calllog* callpath** challenge dircx dirpx dirfx dirrx
  552.           dirsx disks dport e emdir entstr eolstr helpfile home hprompt lib
  553.           lpnono mcommand mconnect menu messages mprefix mprompt msuffix n1
  554.           n2 n3 phones picture plog private rcmdlog* rdisks remote rname*
  555.           rxlog* telno tmp tname* twxfile txlog* welcome xhelpfile
  556.  
  557.       The following parameters can never be modified by the set command: ano
  558.           args c d drive e h nodename oname1...oname5 parity pwd s speed t w
  559.           y y0...y127 yb yf
  560.  
  561.       String Parameters for Remote Operation:
  562.           answerback baudstr bbs call1** call2 call3* callers callpath**
  563.           challenge dircx dirfx dirrx dirsx disks emdir exrc helpfile home
  564.           hprompt intolink* linkpass* menu messages oncloserx onclosetx
  565.           outahost outalink* password private pwd rcmdlog* rdisks rmtcmd*
  566.           rname* rmtcheck* tname* twxfile unrestrict welcome xhelpfile
  567.       String Parameters for Protocol File Transfer:
  568.           adlopts aulopts dirrx dirsx oncloserx onclosetx
  569.       String Parameters for Non Protocol File Transfer:
  570.           blankfill dircx dirfx eolstr toptions
  571.       String Parameters for Interactive Operation:
  572.           Soft Keys altprompt backtab break bs dirpx entstr esc etx lpnono
  573.           mprompt parity rub tab toptions xpassword*
  574.       String Parameters for Scripts:
  575.           ano args c d e h ifs item lib oncloserx onclosetx onexit nodename
  576.           oname1...oname5 remote rxcnt s s0...s9 t tmp toptions y y0...y127
  577.           yb yf
  578.       String Parameters for Making Calls:
  579.           MODEM l m mcommand mconnect mprefix msuffix telno
  580.       String Parameters for Log Keeping:
  581.           callers* calllog* plog rcmdlog* rxlog* txlog*
  582.       Other String Parameters:
  583.           helpfile home kermreset menu onexit picture phones quitcmd
  584.  
  585.  
  586.  
  587.  
  588.  
  589.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  590.  
  591.  
  592.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  593.       ZCOMM User Manual                                                  221
  594.  
  595.       MODEM    (Note this variable name is UPPER CASE to allow importing
  596.                from the environment.) When the advanced dialer described in
  597.                Chapter 8 is used, MODEM contains the file name of the modem
  598.                specific dial routine to use.
  599.  
  600.       adlopts  Contains option(s) to be used for ZMODEM AutoDownloads.
  601.  
  602.                EXAMPLE: set adlopts "r" Use the r option (crash recovery)
  603.                for files automatically downloaded with ZMODEM.
  604.  
  605.       alds     An optional string to be used for controlling Alternate Long
  606.                Distance Services.  On Unix systems, allows assignments to
  607.                the ALT keys a to z.
  608.  
  609.       ano      After invoking one of the date related string parameters, the
  610.                ano string contains the last two digits of the year.
  611.  
  612.       answerback When term is in q (TWX) term option, an answerback is sent
  613.                in response to an incoming ENQ.  The format of Answerback is
  614.                determined by the Western Union Telegraph Company.  It
  615.                typically consists of \r\nNAME CITY\r\n\021 as entered by the
  616.                set command using character escapes.  (In the TWX protocol,
  617.                the 021 (XON) at the end of the answerback turns on the tape
  618.                reader.) The answerback string must begin with CR,LF.
  619.  
  620.       args     contains the complete calling sequence to the current script
  621.                level.
  622.  
  623.                EXAMPLE: call ge,upl accesses the genie telephone directory
  624.                entry and stores ge.upl in args.
  625.  
  626.  
  627.       altprompt Overrides the default auxilliary command prompt generated by
  628.                the ALT-2 key.
  629.  
  630.                EXAMPLE: set altprompt "\r\E[1m%drive:\L%pwd >>>\E[m "
  631.                Display the current disk drive (%c) and directory (%pwd)
  632.                highlighted (\E[1m) and in lower case (\L).
  633.  
  634.                N.B.: If you access Unix systems with ZCOMM, choose an
  635.                altprompt string that is distinct from your Unix prompt.
  636.  
  637.                SEE ALSO: hprompt, mprompt, nodename, drive, pwd string
  638.                parameters
  639.  
  640.       aulopts  Contains option(s) to be used with the sz command.  aulopts
  641.                is processed by the sz command before any options given to
  642.                the command itself.
  643.  
  644.       backtab  Assigns a string or command to the BACKTAB (Shift TAB) key.
  645.  
  646.  
  647.  
  648.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  649.  
  650.  
  651.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  652.       ZCOMM User Manual                                                  222
  653.  
  654.       baudstr  When ZCOMM gets a connect in host operation, ZCOMM executes
  655.                baudstr.
  656.  
  657.                EXAMPLE: set baudstr "@gosub .%lib/baud.t"
  658.  
  659.  
  660.                SEE ALSO: host operation, Chapter 28
  661.  
  662.       bbs      May contain a shell escape command to activate a Bulletin
  663.                Board program via a DOS Gateway.  The bbs string parameter is
  664.                always processed as a shell escape command, and should not
  665.                include a leading "!".  For security reasons, it should
  666.                specify an absolute pathname.
  667.  
  668.                EXAMPLE: set bbs "~bbsprog"
  669.  
  670.  
  671.       blankfill When transmitting a file with the term function with p, r,
  672.                or w term options, ZCOMM sends the contents of blankfill (if
  673.                set) to prevent the remote from receiving a blank (empty)
  674.                line.  (Some programs interpret a blank line as an exit from
  675.                text entry.) ZCOMM Character Escapes must be used to
  676.                represent control characters.  If blankfill is empty, nothing
  677.                is sent. The call command resets blankfill to empty.
  678.  
  679.       break    Stores a string or command to be executed by the Ctrl-Break
  680.                key instead of the default 100 ms break.
  681.  
  682.                EXAMPLE: Some Novation modems cannot pass a break signal:
  683.                  set break "@break putw %B\336\ 1\r putw %U\336\ 0\r"
  684.                Causes the break key to send a break to get the modem's
  685.                attention, then tells the modem to send the break itself, and
  686.                finally restores
  687.  
  688.                the modem's ersatz "transparent" mode.
  689.  
  690.                SEE ALSO: break command
  691.  
  692.       bs       Stores an alternate string or command to be executed by the
  693.                backspace key when in the term function.
  694.  
  695.       c        When the h or s string parameters is accessed, the hundredths
  696.                of a second are stored in the c string parameter.  The
  697.                accuracy and precision of this quantity depend on the
  698.                operating environment.
  699.  
  700.       call1    ** Sets the string to be sent to the modem or command to be
  701.                executed before each time ZCOMM scans for outgoing message
  702.                control scripts.  Typically this would consist of a modem
  703.                command disabling autoanswer, to allow outgoing calls.  This
  704.                string is not used if callpath is empty.
  705.  
  706.  
  707.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  708.  
  709.  
  710.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  711.       ZCOMM User Manual                                                  223
  712.  
  713.                EXAMPLE: set call1 "ATMS0=0\r" (Hayes Modem)
  714.  
  715.  
  716.       call2    Sets the string to be sent to the modem or command to be
  717.                executed each time ZCOMM begins to wait for a call in Host
  718.                State.  Typically this would command the modem to enable
  719.                autoanswer for incoming calls.
  720.  
  721.                EXAMPLE: set call2 "ATMS0=1\r" (Hayes Modem)
  722.  
  723.  
  724.       call3    * Sets the string to be sent to the modem or command to be
  725.                executed each time ZCOMM begins waiting for incoming calls.
  726.                Typically this would consist of a lput command to display an
  727.                informational message on the local screen.  Note that such a
  728.                message will remain on the screen for long periods of time,
  729.                possibly creating an afterimage on the CRT display.
  730.  
  731.                EXAMPLE: set call3
  732.                @lput "\n\nAwaiting Incoming Call.  Press F1 to exit.\n"
  733.  
  734.  
  735.       callers  A pathname in which a log of successful host state logins is
  736.                kept.  If callers is null (the default), no log is kept.
  737.  
  738.                SEE ALSO: Chapter 30, Logging Entries
  739.  
  740.       calllog  * The filename that contains the log of successful autodialed
  741.                calls.  If empty (the default), this function is disabled.  A
  742.                typical entry with 6.3 minutes connect time with a system
  743.                called cis02 is shown.
  744.                C 2143:22 01-25-84 1200 c:226-0627  63 cis02
  745.  
  746.                SEE ALSO: Chapter 30, Logging Entries
  747.  
  748.       callpath ** Sets the ambiguous pathname that scans for scripts to
  749.                transmit outgoing messages.  If empty (the default), no scans
  750.                are made.
  751.  
  752.                EXAMPLE: set callpath "/tmp/outmsg.*"
  753.  
  754.                NOTE: The "disks" string parameter must be set to include any
  755.                drive specified in "callpath".
  756.  
  757.                SEE ALSO: call1, call2 string parameters
  758.  
  759.       challenge is executed when the caller connects and handshakes to
  760.                determine transmission speed.  This script runs without
  761.                restriction, and should check for carrier after each reading
  762.                of data.
  763.  
  764.  
  765.  
  766.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  767.  
  768.  
  769.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  770.       ZCOMM User Manual                                                  224
  771.  
  772.                EXAMPLE: set challenge "@gosub .%lib/challeng.t"
  773.  
  774.  
  775.       d        Is set to the date when called, in the form "mmdd".
  776.  
  777.                EXAMPLE: t cia%d.TXT If the date is December 7, ZCOMM enters
  778.                the term function with capture to KGB1207.txt
  779.  
  780.  
  781.                EXAMPLE: create -st+ cbbs%d.tmp
  782.  
  783.  
  784.                SEE ALSO: h, t string parameters
  785.  
  786.       drive    Is set to the current default disk drive letter when ZCOMM
  787.                starts and when logging into a new disk drive with an A:
  788.                command.  nodename, altprompt, mprompt, hprompt string
  789.                parameters
  790.  
  791.       dircx, dirpx, dirfx, dirrx, dirsx String parameters for
  792.                default/override directories.  Their uses are described in
  793.                Chapter 16.
  794.  
  795.       disks    Contains the disks that may be logged into with with the d:
  796.                command where "d" is the drive letter, or that may appear as
  797.                part of a pathname.  If empty (the default), drive letters
  798.                are not checked.  This parameter should be set to prevent
  799.                local or remote users from hanging the system by accessing an
  800.                off-line disk drive.  This string must be entered in lower
  801.                case.
  802.  
  803.                EXAMPLE: set disks "abc"
  804.  
  805.  
  806.                SEE ALSO: home, rdisks string parameters
  807.  
  808.       dport    Contains the name of the active communications port,
  809.                otherwise empty.
  810.  
  811.                SEE ALSO: port command
  812.  
  813.       drive    Contains the drive letter of the current default DOS disk
  814.                drive.
  815.  
  816.       emdir    A directory pathname for incoming electronic mail files.
  817.                emdir affects twxfile unless twxfile is an absolute path.
  818.                emdir is also used for incoming electronic mail using the
  819.                YMODEM Batch protocol in the absence of a login.
  820.  
  821.                EXAMPLE: set emdir "/memo"
  822.  
  823.  
  824.  
  825.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  826.  
  827.  
  828.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  829.       ZCOMM User Manual                                                  225
  830.  
  831.       entstr   If entstr is set, ZCOMM sends the contents of entstr when
  832.                ENTER (carriage return key) is keyboarded in the term
  833.                function, unless n term option is in effect.  ZCOMM Character
  834.                Escapes must be used to represent control characters.  If
  835.                entstr is empty, a carriage return is sent.  The "call"
  836.                command resets entstr to empty.
  837.  
  838.                EXAMPLE: set entstr "\3"
  839.  
  840.                sends an ETX (octal 3) when Enter is keyboarded.  This is
  841.                handy for some computer systems that expect keyboarded lines
  842.                to be terminated with something other than the usual carriage
  843.                return.
  844.                NOTE: The characters in entstr are always sent at full speed.
  845.  
  846.                SEE ALSO: eolstr string parameter
  847.  
  848.       eolstr   When transmitting a file with the term function with p, r, or
  849.                w term options, ZCOMM sends the contents of eolstr (if set)
  850.                to terminate the line.  ZCOMM Character Escapes must be used
  851.                to represent control characters.  If eolstr is empty, a
  852.                carriage return is sent. The "call" command resets eolstr to
  853.                empty.
  854.  
  855.                EXAMPLE: set eolstr "\r."
  856.  
  857.                sends a carriage return followed by a period at the end of
  858.                each line read from the transmit file.
  859.                NOTE: The characters in eolstr are always sent at full speed.
  860.  
  861.                SEE ALSO: entstr, blankfill string parameters
  862.  
  863.       esc      Stores an alternate string or command to be executed by the
  864.                ESC key when in term function.
  865.  
  866.       etx      Stores an alternate string or command to be executed by ETX
  867.                (Ctrl-C) when in the term function.
  868.  
  869.       exrc     Is sent to the modem/executed when an interactive Host
  870.                Operation session logs out.
  871.  
  872.                EXAMPLE: set exrc "@handshake off; set disks c" turns off
  873.                flow control handshaking and resets the disks parameter in
  874.                case privileged (unrestricted) callers modify this parameter.
  875.  
  876.  
  877.       h        is set to the hour of the day in the form hhmm.
  878.  
  879.                EXAMPLE: echo "It is now %h Hours"
  880.                displays: It is now 1930 Hours.
  881.  
  882.  
  883.  
  884.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  885.  
  886.  
  887.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  888.       ZCOMM User Manual                                                  226
  889.  
  890.                SEE ALSO: hh, mm, d, t string parameters
  891.  
  892.       helpfile The pathname that contains the online help file.  You may
  893.                wish to set this in the phone directory "setup" entry.  Iff
  894.                helpfile begins with the character @, the rest of helpfile is
  895.                treated as a Zcomm command.
  896.  
  897.                SEE ALSO: xhelpfile string parameters, help command, T test
  898.                condition
  899.  
  900.       hh       is set to the hour of the day in the form hh.
  901.  
  902.                EXAMPLE: echo "It is now hour %h."
  903.                displays: It is now hour 09.
  904.  
  905.  
  906.                SEE ALSO: h, mm, d, t string parameters
  907.  
  908.       home     When ZCOMM is invoked, home is set to the current directory.
  909.                When the "cd" command is given without an argument, the
  910.                directory is changed to the contents of home.  When ZCOMM is
  911.                Restricted, absolute pathnames (those beginning with \ or /)
  912.                must have home as a prefix.  This restricts unprivileged
  913.                users to the directory given in home and/or its
  914.                subdirectories on any of the disks allowed by the disks
  915.                string parameter.  When changing the value of home, use
  916.                slashes (/) and not backslases (\), and do not use a disk
  917.                identifier.
  918.  
  919.                SEE ALSO: disks string parameter
  920.  
  921.       hprompt  Overrides the default host operation command prompt.
  922.  
  923.                SEE ALSO: altprompt, mprompt, nodename, drive, pwd string
  924.                parameters
  925.  
  926.       id0-id3  General purpose string parameters that may be used to hold ID
  927.                strings (user account numbers) for script login applications.
  928.  
  929.       ifs      The "Internal Field Separator" string contains the default
  930.                characters to be used by the split command to parse a string
  931.                into fields.
  932.  
  933.       item     * When the expand command is executing a script, the item
  934.                string parameter is set to the pathname of the matched file.
  935.  
  936.       intolink * A command that is executed or a string sent to the modem
  937.                when ZCOMM enters the link command.
  938.  
  939.                EXAMPLE: set intolink "\r" sends CR to the linked computer.
  940.  
  941.  
  942.  
  943.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  944.  
  945.  
  946.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  947.       ZCOMM User Manual                                                  227
  948.  
  949.                EXAMPLE: set intolink "@portx 0f8,2" selects a nonstandard
  950.                link port.
  951.  
  952.                SEE ALSO: linkpass, outalink string parameters
  953.  
  954.       kermreset A string (up to 32 characters) may be sent by Pro-YAM's
  955.                Kermit when it attempts to recover from a transmission error.
  956.                The default value for this string is empty.  Two
  957.                metacharacters are special: \336 inserts a one second pause,
  958.                \335 sends a break.
  959.  
  960.       l        l (letter l) selects a long distance carrier for calls to
  961.                other area codes.  It is set to "1" as a default.  l may be
  962.                set to the access code of the particular alternate long
  963.                distance service desired with a "set" command.
  964.  
  965.                SEE ALSO: m string parameter
  966.  
  967.       lib      A string variable which may be used to indicate the directory
  968.                containing scripts.
  969.  
  970.       linkpass * If set, callers must enter this password when accessing the
  971.                link command.
  972.  
  973.       lpnono   Do not send any of the characters in lpnono to the printer.
  974.                lpnono may use ZCOMM Character Escapes to represent control
  975.                characters.
  976.  
  977.                EXAMPLE: set lpnono "\023" prevents the printer from
  978.                receiving the DC3 (XOFF) character that places some printers
  979.                off line.
  980.  
  981.  
  982.                EXAMPLE: set lpnono "\7" prevents the printing of bell
  983.                characters.
  984.  
  985.  
  986.                SEE ALSO: l mode
  987.  
  988.       m        m selects a long distance carrier for calls within the same
  989.                area code.  It is set to "1" as a default.  m may be set to
  990.                the access code of the particular alternate long distance
  991.                service desired with a "set" command.  It is separate from
  992.                the l string parameter because the default "1" prefix may not
  993.                work if the area code is given, but some alternative long
  994.                distance services require the area code to be specified for
  995.                calls within the same area code.
  996.  
  997.                SEE ALSO: l string parameter
  998.  
  999.  
  1000.  
  1001.  
  1002.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1003.  
  1004.  
  1005.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1006.       ZCOMM User Manual                                                  228
  1007.  
  1008.       mcommand A command that is executed instead of ZCOMM's built in
  1009.                dialing routine.
  1010.  
  1011.                This may be either "gosub dial" which would access the "dial"
  1012.                entry in the phones file, or "source /dial" which would
  1013.                access the script from a separate file.  The second method
  1014.                allows a separate "dial" file for each machine, but requires
  1015.                one more file to be kept track of.
  1016.  
  1017.                Note that mcommand does not start with an @.  The default
  1018.                value is empty, disabling this function.
  1019.  
  1020.                EXAMPLE: set mcommand "gosub dial"
  1021.  
  1022.  
  1023.                SEE ALSO: telno string parameter
  1024.  
  1025.       mconnect A command that is executed or string that is sent to the
  1026.                modem when the modem makes a connection.  A typical use is to
  1027.                set transparent mode for some Novation modems.  The default
  1028.                value is empty, disabling this function.
  1029.  
  1030.       menu     The filename that contains the script accessed by the menu
  1031.                command.
  1032.  
  1033.                EXAMPLE: set menu /host/menu.hst
  1034.  
  1035.  
  1036.       messages Messages entered with the message command are appended to
  1037.                this pathname.  By convention, this file should be readable
  1038.                when ZCOMM is running in Restricted host mode.
  1039.  
  1040.                EXAMPLE: set messages "/host/messages"
  1041.  
  1042.  
  1043.       mprefix  A command that is executed or a string that is sent to the
  1044.                modem as a prefix to dialing a number.  The default ATD works
  1045.                with the Hayes Smartmodem(TM) 1200.  ATDT instructs the modem
  1046.                to use DTMF (Touch Tone(TM)) dialing instead of pulse
  1047.                dialing.  Character escapes may be used.
  1048.  
  1049.       mm       is set to the minute of the hour. It expands to the form mm.
  1050.  
  1051.                EXAMPLE: echo "It is now %h minutes past the hour"
  1052.                displays: It is now 30 minutes past the hour.
  1053.  
  1054.  
  1055.                SEE ALSO: h, hh, d, t string parameters
  1056.  
  1057.       mprompt  Overrides the default main command prompt.
  1058.  
  1059.  
  1060.  
  1061.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1062.  
  1063.  
  1064.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1065.       ZCOMM User Manual                                                  229
  1066.  
  1067.                EXAMPLE: set mprompt "\r\E[1m%drive:\L%pwd <<<\E[m "
  1068.                Display the current disk drive (%c) and directory (%pwd)
  1069.                highlighted (\E[1m) and in lower case (\L).
  1070.  
  1071.                N.B.: If you access Unix systems with ZCOMM, choose an
  1072.                mprompt string that is distinct from your Unix prompt.
  1073.  
  1074.                EXAMPLE: set mprompt "\r\E[1m%nodename:%drive:\L%pwd <<<\E[m
  1075.                "
  1076.  
  1077.  
  1078.                SEE ALSO: altprompt, hprompt, nodename, drive, pwd string
  1079.                parameters
  1080.  
  1081.       msuffix  A command that is executed or a string sent to the modem
  1082.                after the last digit in the phone number.  Most intelligent
  1083.                modems require the default value of "\r".
  1084.  
  1085.       n0-n9    General purpose string parameters.
  1086.  
  1087.       nodename Contains the node name given to individual Unix and Xenix
  1088.                systems.  On other systems this must be set by a script.
  1089.  
  1090.                SEE ALSO: Unix uname command
  1091.  
  1092.       oname1...oname5 contains the information stored by the args string
  1093.                parameter for each level.
  1094.  
  1095.       oncloserx Optional user exit commands to execute after each file is
  1096.                received with a protocol file transfer.* Its use is described
  1097.                in Chapter 13.
  1098.  
  1099.       onclosetx Optional user exit commands to execute after each file is
  1100.                sent with a protocol file transfer.* Its use is described in
  1101.                Chapter 13.
  1102.  
  1103.       onexit   Optional commands to execute as ZCOMM exits to the operating
  1104.                system.
  1105.  
  1106.                EXAMPLE: set onexit "@echo GOODBYE!!"
  1107.  
  1108.  
  1109.       outahost A command that is executed or a string sent to the modem when
  1110.                ZCOMM exits host operation with a F1 or ALT-N key.
  1111.  
  1112.                EXAMPLE: set outahost ATZ\r sends the ATZ command to a Hayes
  1113.                modem to restore its default no autoanswer state.
  1114.  
  1115.  
  1116.       outalink * A command that is executed or a string sent to the modem
  1117.                when ZCOMM exits the link command.
  1118.  
  1119.  
  1120.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1121.  
  1122.  
  1123.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1124.       ZCOMM User Manual                                                  230
  1125.  
  1126.                EXAMPLE: set outalink "@kill; px0" clears the circular buffer
  1127.                and prevents restricted callers from accessing the link
  1128.                command.
  1129.  
  1130.  
  1131.                SEE ALSO: intolink string parameter
  1132.  
  1133.       parity   Contains a string representation of the number of data bits
  1134.                and parity, such as 8n.
  1135.  
  1136.       password Changes the password callers must enter to gain access to
  1137.                your computer when ZCOMM is in host operation.  If password
  1138.                is empty no password will be demanded.
  1139.  
  1140.                EXAMPLE: set password "Change This Already"
  1141.  
  1142.  
  1143.                SEE ALSO: challeng.t script, demand command
  1144.  
  1145.       phones   The filename that contains the telephone directory entries
  1146.                and associated commands used with the call and gosub
  1147.                commands.  The default is "/PHODIR.t".  The default may be
  1148.                changed at installation time by the putsnp program.  The DOS
  1149.                environment variable PHONES will override the default when
  1150.                ZCOMM is started.  Finally, a set command may be used to
  1151.                change the telephone directory once ZCOMM has started.
  1152.  
  1153.       picture  The filename used by the ALT-Z command to "zap" a copy of the
  1154.                display memory to the specified file.
  1155.  
  1156.       plog     The filename that contains the file transfer performance log.
  1157.                If empty (the default), this function is disabled.
  1158.  
  1159.                SEE ALSO: Chapter 30, Logging Entries
  1160.  
  1161.       private  Pathname that messages are stored into by the private
  1162.                command.  This file should NOT be readable when ZCOMM is
  1163.                running in Restricted host mode.
  1164.  
  1165.                EXAMPLE: set private "/private"
  1166.  
  1167.  
  1168.       pw0-pw3  General purpose string parameters for holding passwords.  If
  1169.                defined with a set _pw0 "secretpw" command, it will be
  1170.                cleared with the next call command.
  1171.  
  1172.       pwd      This parameter is set to the current working directory by
  1173.                each cd and pwd command.
  1174.  
  1175.       quitcmd  Sets the string to be sent to the modem or command to be
  1176.                executed when a protocol file transfer has been completed if
  1177.  
  1178.  
  1179.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1180.  
  1181.  
  1182.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1183.       ZCOMM User Manual                                                  231
  1184.  
  1185.                the ALT-Q key was typed during that transfer.
  1186.  
  1187.                EXAMPLE: set quitcmd t\r\336\r\336\r\025off\r would send
  1188.                t<ENTER>, a pause, <ENTER>, a pause, <ENTER>, and
  1189.                ^Uoff<ENTER>.  This sequence may be useful for automatically
  1190.                logging off Compuserve after downloading a file.
  1191.  
  1192.  
  1193.                SEE ALSO: ALT-Q special key
  1194.  
  1195.       rcmdlog  * The filename that contains the log of commands issued
  1196.                remotely (in Host Operation) along with the time,
  1197.                transmission speed, and the name of the caller.  If set to
  1198.                "prn", the commands are logged on the printer.  A highly
  1199.                buffered printer, hard disk file or ramdisk file is
  1200.                recommended because this file will be opened and closed for
  1201.                each host command.  If empty (the default), this function is
  1202.                disabled.
  1203.  
  1204.                EXAMPLE: set rcmdlog D:rcmds
  1205.  
  1206.  
  1207.                SEE ALSO: Chapter 30, Logging Entries
  1208.  
  1209.       rdisks   Contains the disks that may be logged into with with the d:
  1210.                command where "d" is the drive letter, or that may appear as
  1211.                part of a pathname, when ZCOMM is Restricted.  If empty (the
  1212.                default), drive letters are not checked against this
  1213.                parameter.  (Drive letters are always checked with the disks
  1214.                parameter.) The rdisks parameter is used to prevent
  1215.                restricted remote users from accessing private data files.
  1216.                This string must be entered in lower case.
  1217.  
  1218.                EXAMPLE: set rdisks "c"
  1219.  
  1220.  
  1221.                SEE ALSO: home, disks string parameters
  1222.  
  1223.       remote   ZCOMM reads The full name of the remote system from the
  1224.                telephone directory entry when the call command is given.
  1225.  
  1226.                EXAMPLE: call omen using the omen entry in the distributed
  1227.                PHODIR.t file assigns omen-tech to the remote string
  1228.                parameter.
  1229.  
  1230.                In Host Operation, the caller's name is read into remote.
  1231.  
  1232.                SEE ALSO: call command, xpassword string parameter, \PXXXX
  1233.                character escape
  1234.  
  1235.  
  1236.  
  1237.  
  1238.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1239.  
  1240.  
  1241.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1242.       ZCOMM User Manual                                                  232
  1243.  
  1244.       rmtcheck Sets the string to be sent to the modem or command to be
  1245.                executed each time ZCOMM accepts a command line or ZMODEM
  1246.                protocol Command Download from the remote caller when in Host
  1247.                Operation, before that command is executed.
  1248.  
  1249.                SEE ALSO: rmtcmd, pwd string parameters
  1250.  
  1251.                EXAMPLE: set rmtcheck "@source D:remcheck.t"
  1252.  
  1253.  
  1254.       rmtcmd   Contains the command line entered by the caller or received
  1255.                by ZMODEM protocol Command Download in Host Operation.  This
  1256.                may be modified by an unrestricted script invoked via the
  1257.                rmtcheck string parameter.
  1258.  
  1259.                SEE ALSO: rmtcheck string parameter, checkrmt.t script
  1260.  
  1261.       rname    * Contains the name of the last file received by a protocol,
  1262.                successful or not.
  1263.  
  1264.       rub      Assigns a string or command to the RUBOUT (Shift Backspace)
  1265.                key.
  1266.  
  1267.       rxcnt    A three digit number which counts the number of files that
  1268.                have been created for receiving.  An incoming file with an
  1269.                illegal name is changed to rename.n with n is incremented
  1270.                from the value stored in rxcnt (or 0).
  1271.  
  1272.       rxlog    * The filename that contains the log of received files.  If
  1273.                empty (the default), this function is disabled.
  1274.  
  1275.                SEE ALSO: Chapter 30, Logging Entries
  1276.  
  1277.       s        * Contains the current time in seconds since the last minute.
  1278.  
  1279.       s0...s9  These may be tested with the if %sN and if i%sN,string
  1280.                commands, or expanded into a string using character escapes
  1281.                with the "%sN" construction, where N is 1...9.  Use set param
  1282.                "" (empty string enclosed by double quote characters) to set
  1283.                a string parameter to empty.
  1284.  
  1285.       speed    String representation of the serial port speed.
  1286.  
  1287.       statliner May be used to place a messgae in the right side of the term
  1288.                function status line, replacing the information normally
  1289.                displayed there.  If statliner begins with a space, it is
  1290.                placed at the far right of the status line, after the
  1291.                information normally displayed.  If statliner does not begin
  1292.                with a space, it is processed for string substitution and
  1293.                character escapes, and then placed at column 31 of the status
  1294.                line.
  1295.  
  1296.  
  1297.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1298.  
  1299.  
  1300.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1301.       ZCOMM User Manual                                                  233
  1302.  
  1303.       Soft Keys can either send strings or execute commands.  If the
  1304.                assigned string begins with "@" (commercial at), the string
  1305.                is executed as a command.
  1306.  
  1307.                A soft key command called from the term function should not
  1308.                end with a t or f command because this would cause excessive
  1309.                recursion (calling the term function from within the term
  1310.                function).  (Use the create or open instead.)
  1311.  
  1312.                The alta to altz, f1 to fa12 strings are executed by the
  1313.                respective keys from the term function, review function, or
  1314.                command prompt.  In the term function, soft keys definitions
  1315.                for fins, fdel, fhome, fup, fdown, fpgup, fpgdn, fleft,
  1316.                fright, fend will override ZCOMM's built-in definitions for
  1317.                these keys.  The built-in definitions take precedence in the
  1318.                review function, conference command, and at the command
  1319.                prompt.  In the conference command, soft keys are inserted
  1320.                into the editing window unless they are commands, which are
  1321.                executed.  Soft keys are not executed from review or the
  1322.                command prompt unless they are commands (beginning with "@").
  1323.  
  1324.                Computers with the 101 key extended keyboard and ROM BIOS
  1325.                support allow ZCOMM to distinguish the cursor cluster keys
  1326.                and the two new function keys labelled F11 and F12.  Extended
  1327.                keyboard cursor cluster keys may be reassigned with the
  1328.                fcdel, fcdown, fcend, fchome, fcins, fcleft, fcpgdn, fcpgup,
  1329.                fcright, and fcup string parameters.  The fnp5 key may be
  1330.                assigned to the "5" key on the numeric pad.[2] ZCOMM's
  1331.                character escapes can be used to encode special characters,
  1332.                including spaces and/or tabs.
  1333.  
  1334.                EXAMPLE: set bs "\177";  set rubout "\b" Swap backspace and
  1335.                rubout for VMS
  1336.  
  1337.  
  1338.                Bound Soft Keys are displayed by ALT-K and keys commands.
  1339.  
  1340.                EXAMPLE: set f3 @rb Assigns the rb command to F3.
  1341.  
  1342.  
  1343.       t        expands to the current time and date each time it is used.
  1344.  
  1345.                SEE ALSO: d, h string parameters
  1346.  
  1347.  
  1348.  
  1349.       __________
  1350.  
  1351.        2. Visible on extended 101 key keyboards with extended BIOS support
  1352.           only
  1353.  
  1354.  
  1355.  
  1356.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1357.  
  1358.  
  1359.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1360.       ZCOMM User Manual                                                  234
  1361.  
  1362.       tab      Assigns a string or command to the TAB key.
  1363.  
  1364.       telno    The current telephone number string.
  1365.  
  1366.                SEE ALSO: mcommand string parameter
  1367.  
  1368.       tmp      A string variable which may be used to indicate the directory
  1369.                used for data to be transmitted or received.
  1370.  
  1371.       tname    * Contains the name of the last file sent with a protocol,
  1372.                successful or not.
  1373.  
  1374.       toptions Contains optional term function options to be applied to each
  1375.                instance of the following term function commands: conference,
  1376.                create, f, learn, t and F-2
  1377.  
  1378.                SEE ALSO: term funcion options, Chapter 22.
  1379.  
  1380.       txlog    * The filename that contains the log of transmitted files.
  1381.                If empty (the default), this function is disabled.
  1382.  
  1383.                SEE ALSO: Chapter 30, Logging Entries
  1384.  
  1385.       unrestrict Changes the password callers must match to allow remote
  1386.                functions that are normally restricted such as erasing files,
  1387.                listing and changing parameters, and changing to private
  1388.                directories.  If unrestrict is empty (the default), the
  1389.                unrestrict command will fail.
  1390.  
  1391.                SEE ALSO: unrestrict command
  1392.  
  1393.       w        Contains the day of the week (local time) as Mon, Tue, Wed,
  1394.                Thu, Fri, Sat, or Sun.
  1395.  
  1396.       welcome  is executed after the password (if any) has been demanded and
  1397.                accepted.
  1398.  
  1399.                EXAMPLE: set welcome "@type welcome.txt; purgek; nulls 0"
  1400.  
  1401.  
  1402.       xhelpfile The pathname that contains the online help file for host
  1403.                mode commands.  This should be readable when ZCOMM is in
  1404.                Restricted Host Operation.  Iff xhelpfile begins with the
  1405.                character @, the rest of xhelpfile is treated as a Zcomm
  1406.                command.
  1407.  
  1408.                SEE ALSO: helpfile string parameters, help command
  1409.  
  1410.       xpassword * xpassword is a master password string that may be used to
  1411.                generate a unique password for each system called.  xpassword
  1412.                is encrypted by the name of the remote system (string
  1413.  
  1414.  
  1415.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1416.  
  1417.  
  1418.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1419.       ZCOMM User Manual                                                  235
  1420.  
  1421.                parameter remote) to generate a password unique to each
  1422.                remote system called.  The generated password is transmitted
  1423.                as a result of a Soft Key programmed with the \PXXXX
  1424.                construction described in Chapter 26.  To view the generated
  1425.                password, set the remote string parameter to the full remote
  1426.                system name as it appears in the appropriate telephone
  1427.                directory (up to but not including any "-" character), then
  1428.                keyboard lput \PXXXX from the main command prompt.
  1429.  
  1430.                EXAMPLE: set f8 "\PXXXX" Programs F8 to transmit a 5
  1431.                character password from the term function.
  1432.                Omen Technology Inc cannot accept responsibility for damages
  1433.                due to the breaking of any codes used or generated by ZCOMM.
  1434.  
  1435.       uucplock Contains an optional UUCP lock file prefix for arbitrating
  1436.                tty ports with the Unix UUCP program.  This is normally set
  1437.                automatically, or from the UUCPLOCK environment variable.
  1438.  
  1439.                EXAMPLE: set uucplock "/usr/spool/locks/LCK.."
  1440.  
  1441.  
  1442.       y        expands to represent the y string parameter current line.
  1443.  
  1444.       y0...y127 Read only string parameters y0 to y127 represent lines
  1445.                displayed by the term function.  y0 corresponds to the
  1446.                current partially finished line as displayed by the term
  1447.                function.  The last line referenced by y0...y127 becomes the
  1448.                y string parameter current line used by the y, yb, and yf
  1449.                string parameters.  Each time the term function displays a
  1450.                newline from the remote, the y string parameter current line
  1451.                points to the new, unfinished line from the remote.
  1452.  
  1453.       yb       Referencing the yb read only string parameter backs up the y
  1454.                string parameter current line one line, and then represents
  1455.                that line.
  1456.  
  1457.       yf       Referencing the yb read only string parameter advances the y
  1458.                string parameter current line one line, and then represents
  1459.                that line.
  1460.  
  1461.                SEE ALSO: H, h test conditions
  1462.  
  1463.       zmrxesc  Requests the sending ZMODEM-90(TM) program to escape the
  1464.                specified additional control character(s).  Printing
  1465.                characters @ (40 hex) to _ (57 hex) escape the corresponding
  1466.                control characters NULL (0) to US (1F) in both parities.
  1467.  
  1468.                EXAMPLE: set zmrxesc "@" Requests the sending program to
  1469.                escape NULL (0) and NULL with 8th bit set (80 hex).
  1470.  
  1471.                SEE ALSO: zmtxesc string parameter
  1472.  
  1473.  
  1474.       (C) 1993 Omen Tech Inc                    Chapter 25 String Parameters
  1475.  
  1476.  
  1477.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1478.       ZCOMM User Manual                                                  236
  1479.  
  1480.       zmtxesc  Causes ZMODEM send commands to escape the specified
  1481.                additional control character(s).  Printing characters @ (40
  1482.                hex) to _ (57 hex) escape the corresponding control
  1483.                characters NULL (0) to US (1F) in both parities.
  1484.  
  1485.                SEE ALSO: zmrxesc string parameter
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501.  
  1502.  
  1503.  
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.       (C) 1993 Omen Tech Inc                    Chapter 25 Character Escapes
  1534.  
  1535.  
  1536.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1537.       ZCOMM User Manual                                                  237
  1538.  
  1539.       26.  CHARACTER ESCAPES
  1540.  
  1541.       Some commands use strings with character escapes similar to those used
  1542.       by the C programming language for describing string constants.  When
  1543.       translating a string for character escapes, ZCOMM substitutes strings
  1544.       (%svar) and then translates the result for backslash (\) encoded
  1545.       character escapes.
  1546.  
  1547.               String-Parameter    %svar
  1548.               Environment-Param   %SVAR
  1549.               % (per cent)        \045
  1550.               password*           \PXXXXXXX
  1551.               cleartext*          \C+clear-text+
  1552.               ciphertext*         \M+ciphertext+
  1553.               newline (LF)        \n
  1554.               return (CR)         \r
  1555.               tab (HT)            \t
  1556.               alarm (BEL)         \a
  1557.               backspace (BS)      \b
  1558.               form feed (FF)      \f
  1559.               escape (ESC)        \E
  1560.               transparent         \T
  1561.               lowercase           \L
  1562.               uppercase           \U
  1563.               octal byte          \nnn
  1564.               decimal byte        \dnnn
  1565.               hex byte            \xHH
  1566.               control char        \^C
  1567.               concatenation       \&
  1568.               backslash           \\
  1569.  
  1570.       To preserve compatibility with future TurboDial enhancements, a
  1571.       backslash should not be followed by a character not listed above.
  1572.  
  1573.       %svar is replaced by the value of the corresponding string parameter.
  1574.       The string parameter name must be written exactly, in the correct
  1575.       case, with no extra letters or digits at the end.  Any non
  1576.       alphanumeric character delimits the parameter name.  The DOS
  1577.       environment is searched for parameters after exhausting the ZCOMM
  1578.       string parameters.[1]
  1579.  
  1580.       \PXXXXXXX uses the xpassword and remote string parameters to generate
  1581.       a password unique to each remote system, replacing each X character
  1582.       with an upper case alphabetic character.* The xpassword parameter must
  1583.       have at least as many characters as the number of characters used in
  1584.  
  1585.  
  1586.       __________
  1587.  
  1588.        1. DOS environment parameters are upper case only
  1589.  
  1590.  
  1591.  
  1592.       (C) 1993 Omen Tech Inc                    Chapter 26 Character Escapes
  1593.  
  1594.  
  1595.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1596.       ZCOMM User Manual                                                  238
  1597.  
  1598.       the \PXXXXX construction.
  1599.  
  1600.       SEE ALSO: xpassword, remote string parameters
  1601.  
  1602.       \M+ciphertext+ uses a cipher and the contents of the mpassword string
  1603.       parameter to decrypt and transmit the cleartext equivalent to
  1604.       ciphertext.  Ciphertext is delimited by the character immediately
  1605.       following "M".
  1606.  
  1607.       \C+cleartext+ is treated as above, except for no decryption.
  1608.  
  1609.       EXAMPLE: \C+foobar+ is translated to foobar by ZCOMM's character
  1610.       escape expansion.
  1611.  
  1612.  
  1613.       A separate program pga encrypts instances of \C+cleartext+ into
  1614.       \M+ciphertext+ according to a user specified master password.  Pga
  1615.       also decrypts \M sequences to either cleartext, or encrypts them with
  1616.       a new master password.  Please refer to Chapter 99.
  1617.  
  1618.       The \n, \r, \t, \b, \f, \E, \nnn, \xHH, \^C and \\ character escapes
  1619.       generate the associated character.
  1620.  
  1621.       The \T character escape inhibits the processing of character eascpes
  1622.       (but not string substitutions) in the remainder of the string.  It is
  1623.       useful when the raw string contains backslashes which must not be
  1624.       treated as character escapes.
  1625.  
  1626.       The \L character escape forces the rest of the string to lower case,
  1627.       up to the next \ character.  Likewise, \U forces upper case.
  1628.  
  1629.       Octal byte escapes (\nnn) accept 1 to 3 octal digits terminated by the
  1630.       first non octal digit.  Decimal byte escapes (\dnnn) accept 1 to 3
  1631.       digits terminated by the first non digit.  Hex byte escapes (\xHH)
  1632.       accept exactly 2 hex digits.  Control characters may also be
  1633.       represented by \^C where C is the printing representation for Ctrl-C
  1634.       and ^ is the circumflex character.
  1635.  
  1636.       The \& character escape generates nothing; it is useful to delimit the
  1637.       lexical end of a string parameter name in string concatenation
  1638.       applications.
  1639.  
  1640.  
  1641.       26.1  Concatenating String Parameters
  1642.  
  1643.       To concatenate the contents of a string parameter with other
  1644.       characters, one must escape the next character with a backslash if it
  1645.       is a letter or digit.  The \& character escape expands to nothing.
  1646.  
  1647.       EXAMPLE: Assume string parameter s1 contains "foo".
  1648.            putw "%s1\&bar"
  1649.  
  1650.  
  1651.       (C) 1993 Omen Tech Inc                    Chapter 26 Character Escapes
  1652.  
  1653.  
  1654.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1655.       ZCOMM User Manual                                                  239
  1656.  
  1657.       sends "foobar".
  1658.            putw "%s1\142bar"
  1659.       sends "foobbar".
  1660.            putw "%s1-skidoo"
  1661.       sends "foo-skidoo".
  1662.            putw "%s1bar"
  1663.       is undefined.
  1664.            putw "%s1\bar"
  1665.       sends "foo<BS>ar"
  1666.  
  1667.       Failure to observe this property causes the sets and put commands to
  1668.       give unexpected results.
  1669.  
  1670.       An encrypted password* is generated from the prototype string
  1671.       \PXXXXXXXX where each X generates an upper case alphabetic character
  1672.       by encrypting the leading letters of the remote system name by
  1673.       xpassword.
  1674.  
  1675.       Only the leading letters of the remote system name are used to allow a
  1676.       directory to have a number of alternate access methods for a given
  1677.       system, yet produce the same automatic password.  For example,
  1678.       "source", "source-telenet", "source300" would all generate the same
  1679.       password, but "sourceb" would generate a different password.
  1680.       xpassword must have at least as many characters as X characters in the
  1681.       prototype string.
  1682.  
  1683.       Omen Technology Inc and sellers of ZCOMM cannot accept any
  1684.       responsibility for damages due to the breaking of any ciphers used or
  1685.       generated by ZCOMM.
  1686.  
  1687.       An arbitrary byte is generated by backslash followed by one to three
  1688.       octal digits, backslash x followed by exactly two hex digits, or by
  1689.       backslash circumflex followed by three decimal digits.  7 bit term
  1690.       options (7s, 7m, 7e, 7o) modify the parity bit of characters
  1691.       transmitted by the term function during the put[w] command.
  1692.  
  1693.  
  1694.       26.2  Quoting Strings
  1695.  
  1696.       Strings must be enclosed by double quotes (Shift ' on the IBM Personal
  1697.       Computer) to allow white space and/or semicolon to be included in the
  1698.       string.  If a string containing white space were not quoted, it would
  1699.       be terminated by the first space or tab, and ZCOMM would consider the
  1700.       rest of the intended string as another (incorrect) command.
  1701.  
  1702.       26.3  Layering of Escaped Characters
  1703.  
  1704.       Sometimes a string will be processed two (or more) times by ZCOMM's
  1705.       character escapes.
  1706.  
  1707.            set fs2 "@accept s1 Name:; obey find\ \\n%s1\ %phones"
  1708.  
  1709.  
  1710.       (C) 1993 Omen Tech Inc                      Chapter 26 Quoting Strings
  1711.  
  1712.  
  1713.       Version 18.05 TurboDial 2.36            Universal Line Printer Edition
  1714.       ZCOMM User Manual                                                  240
  1715.  
  1716.       This example causes ZCOMM to ask for a name when Shift-F2 is typed.
  1717.       The name is read into string parameter S1, which is then used as part
  1718.       of the argument for the find command.  The find command searches the
  1719.       telephone directory for lines beginning with the string you just typed
  1720.       in.  To match only lines starting with the given string, a linefeed
  1721.       (\n) is prepended to the argument of the find command.  When the obey
  1722.       command executes, the backslash-space sequences translate to spaces,
  1723.       and the double backslash translates to a single backslash.
  1724.  
  1725.       The space after "find" and after "%s1" must be escaped because the
  1726.       obey command accepts a single string argument.  If these spaces were
  1727.       not escaped, the obey command would not "see" the rest of the line
  1728.       after "find".
  1729.  
  1730.       The find command performs its own character escape translation,
  1731.       changing the \n to a linefeed character.
  1732.  
  1733.       Since the find command performs string substitution on its list of
  1734.       files, it is not actually necesary to use the obey command here:
  1735.  
  1736.            set fs2 "@accept s1 Name:; find \n%s1 %phones"
  1737.  
  1738.       26.4  Regular Expressions
  1739.  
  1740.       Regular Expressions allow TurboDialTm scripts to search and parse data
  1741.       from files, the keyboard, and remote computers.  Regular expressions
  1742.       are used for string searching and parsing (splitting) with the ss and
  1743.       egrep commands, and the h and H test conditions.
  1744.  
  1745.       Many DOS and Unix programs use regular expressions to search and parse
  1746.       text, including grep, egrep, many flavors of EMACS, Brief, Epsilon,
  1747.       ed, vi, sed, lex, and Perl.  The effort expended in learning how to
  1748.       use regular expressions will be rewarded by the increased utility of
  1749.       dozens of programs and tools, not just ZCOMM.
  1750.  
  1751.       ZCOMM regular expressions give "magic" meanings to the characters \ *
  1752.       + ? . | ^ [ ] ( )
  1753.  
  1754.       A regular expression is zero or more branches, separated by |.  It
  1755.       matches anything that matches one of the branches.
  1756.  
  1757.       A branch is zero or more pieces, concatenated.  It matches a match for
  1758.       the first, if it is followed by a match for the second, etc.
  1759.  
  1760.       A piece is an atom possibly followed by *,+, or?.  An atom followed by
  1761.       * matches a sequence of 0 or more matches of the atom.  An atom
  1762.       followed by + matches a sequence of 1 or more matches of the atom.  An
  1763.       atom followed by ? matches a match of the atom, or the null string.
  1764.  
  1765.       An atom is a regular expression in parentheses (matching a match for
  1766.       the regular expression), a range (see below), .  (matching any single
  1767.  
  1768.  
  1769.       (C) 1993 Omen Tech Inc                  Chapter 26 Regular Expressions
  1770.  
  1771.